home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / standard / bgnclosedline.z / bgnclosedline
Text File  |  1998-10-20  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. bbbbggggnnnncccclllloooosssseeeeddddlllliiiinnnneeee((((3333GGGG))))                                            bbbbggggnnnncccclllloooosssseeeeddddlllliiiinnnneeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bbbbggggnnnncccclllloooosssseeeeddddlllliiiinnnneeee,,,, eeeennnnddddcccclllloooosssseeeeddddlllliiiinnnneeee - delimit the vertices of a closed line
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd bbbbggggnnnncccclllloooosssseeeeddddlllliiiinnnneeee(((())))
  13.  
  14.      vvvvooooiiiidddd eeeennnnddddcccclllloooosssseeeeddddlllliiiinnnneeee(((())))
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _n_o_n_e
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      bbbbggggnnnncccclllloooosssseeeeddddlllliiiinnnneeee marks the start of a group of vertex routines that you want
  21.      interpreted as points on a closed line.  Use eeeennnnddddcccclllloooosssseeeeddddlllliiiinnnneeee to mark the
  22.      end of the vertex routines that are part of the closed line.
  23.  
  24.      A closed line draws a line segment from one vertex on the list to the
  25.      next vertex on the list. When the system reaches the end of the vertex
  26.      list, it draws a line that connects the last vertex to the first vertex.
  27.      All segments use the current linestyle, which is reset prior to the first
  28.      segment and continues through subsequent segments.  To specify a vertex,
  29.      use the vvvv routine.
  30.  
  31.      Between bbbbggggnnnncccclllloooosssseeeeddddlllliiiinnnneeee and eeeennnnddddcccclllloooosssseeeeddddlllliiiinnnneeee, you can issue only the following
  32.      Graphics Library routines: cccc, ccccoooolllloooorrrr, ccccppppaaaacccckkkk, llllmmmmbbbbiiiinnnndddd, llllmmmmccccoooolllloooorrrr, llllmmmmddddeeeeffff, nnnn,
  33.      RRRRGGGGBBBBccccoooolllloooorrrr, tttt, and vvvv.  Within a closed line, you should use llllmmmmddddeeeeffff and
  34.      llllmmmmbbbbiiiinnnndddd only to respecify materials and their properties.  If the color
  35.      changes between a pair of vertices, the color of the line segment will be
  36.      constant if the current shading model is FLAT and interpolated if the
  37.      current shading model is GOURAUD.  In color map mode, the colors vary
  38.      through the color map; to get reasonable results, the color map should
  39.      contain a ramp.
  40.  
  41.      There is no limit to the number of vertices that can be specified between
  42.      bbbbggggnnnncccclllloooosssseeeeddddlllliiiinnnneeee and eeeennnnddddcccclllloooosssseeeeddddlllliiiinnnneeee.  After eeeennnnddddcccclllloooosssseeeeddddlllliiiinnnneeee, the system draws a
  43.      line from the final vertex back to the initial vertex, and the current
  44.      graphics position is left undefined.
  45.  
  46.      By default, line vertices are forced to the nearest pixel center prior to
  47.      scan conversion.  Line accuracy is improved when this coercion is
  48.      defeated with the ssssuuuubbbbppppiiiixxxxeeeellll command.  Subpixel vertex positioning is
  49.      especially important when lines are scan-converted with antialiasing
  50.      enabled (see lllliiiinnnneeeessssmmmmooooooootttthhhh).
  51.  
  52.      bbbbggggnnnncccclllloooosssseeeeddddlllliiiinnnneeee/eeeennnnddddcccclllloooosssseeeeddddlllliiiinnnneeee are the same as bbbbggggnnnnlllliiiinnnneeee/eeeennnnddddlllliiiinnnneeee, except they
  53.      connect the last vertex to the first.
  54.  
  55. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  56.      The code fragment below draws the outline of a triangle. Lines use the
  57.      current linestyle, which is reset prior to the first vertex and continues
  58.      through all subsequent vertices.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. bbbbggggnnnncccclllloooosssseeeeddddlllliiiinnnneeee((((3333GGGG))))                                            bbbbggggnnnncccclllloooosssseeeeddddlllliiiinnnneeee((((3333GGGG))))
  71.  
  72.  
  73.  
  74.           bgnclosedline();
  75.           v3f(vert1);
  76.           v3f(vert2);
  77.           v3f(vert3);
  78.           endclosedline();
  79.  
  80.  
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.      bgnline, c, linesmooth, linewidth, lsrepeat, scrsubdivide, setlinestyle,
  83.      shademodel, subpixel, v
  84.  
  85. BBBBUUUUGGGGSSSS
  86.      On the IRIS-4D B and G models, and on the Personal Iris without Turbo
  87.      Graphics, if the color changes between a pair of vertices, the color of
  88.      the line segment will be constant regardless of the current shading
  89.      model.
  90.  
  91.      On the IRIS-4D GT and GTX models, if the color changes between a pair of
  92.      vertices, the color of the line segment will be interpolated regardless
  93.      of the current shading model.
  94.  
  95.      On the IRIS-4D B and G models, the linestyle is reset at the start of
  96.      each segment, rather than only at the start of the first segment.
  97.  
  98.      On Impact and Infinite Reality llllmmmmccccoooolllloooorrrr cannot be called between
  99.      bbbbggggnnnncccclllloooosssseeeeddddlllliiiinnnneeee and eeeennnnddddcccclllloooosssseeeeddddlllliiiinnnneeee
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.